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APPENDIX E 

Example Loading And Execution Control Program 



public class Bootstrap { 



// Constants 


used 


throughout the program 




static 


final 


byte 


BUFF ER_LENGT H 


— "J "5 . 


static 


final 


byte 


ACK_SIZE 


= (byte)l; 


static 


final 


byte 


ACK_CODE 


= (byte)O; 


static 


final 


byte 


OS_HEADER_SIZE 


= (byte) 0x10; 


static 


final 


byte 


GPOS_CREATE_FILE 


= (byte)OxEO; 


static 


final 


byte 


S T_ INVAL I D_C LAS S 


= (byte)OxCO; 


static 


final 


byte 


ST_INVALID_PARAMETER 


= (byte)OxAO; 


static 


final 


byte 


ST_INS_NOT_SUPPORTED 


= (byte)OxBO; 


static 


final 


byte 


ST_SUCCESS 


= (byte) 0x00; 


static 


final 


byte 


I SO_COMMAND_LENGTH 


= (byte) 5; 


static 


final 


byte 


I SO_READ_B I NARY 


= (byte)OxBO; 


static 


final 


byte 


I SO_UPDATE_B INARY 


= (byte)0xD6; 


static 


final 


byte 


ISO_INIT_APPLICATION 


= (byte)0xF2; 


static 


final 


byte 


ISO_VERIFY_KEY 


= (byte)0x2A; 


static 


final 


byte 


ISO_SELECT_FILE 


= (byte)0xA4; 


static 


final 


byte 


ISO_CLASS 


= (byte)OxCO; 


static 


final 


byte 


ISO_APP_CLASS 


= (byte)OxFO; 



public static void main () { 

byte pbuffer[] = new byte [ ISO_COMMAND_LENGTH] ; 

byte dbuffer[] = new byte [ BUFFER_LENGTH ] ; 

byte ackByte[] = new byte [ACK_SIZE] ; 

//short fileld; 

short offset; 

byte bRe turns tatus; 

// Initialize Communications 
_OS.SendATR() ; 

do { 

// Retrieve the command header 

_OS.GetMessage(pbuf fer, ISO_COMMAND_LENGTH, ACK_CODE) ; 

// Verify class of the message - Only ISO + Application 
if ((pbuffertO] != ISO_APP_CLASS) 
&& (pbuffertO] != ISO_CLASS) ) { 

_OS .SendS tatus (ST_INVALID_CLASS) ; 

} 

else { 

// go through the switch 

// Send the acknowledge code 

// Verify if data length too large 
if (pbuffer[4] > BUFFER_LENGTH ) { 

bReturnStatus = ST_INVALID_PARAMETER; 

) 

else 
{ 

switch (pbuffer(lj) { 
case ISO_SELECT_FILE: 

//we always assume that length is 2 

if (pbuffer[4] != 2) { 

bReturnStatus - ST_INVALID_PARAMETER ; 

} 

else 
{ 

// get the fileld (of f set) in the data buffer 
_OS.GetMessage(dbuf fer, (byte) 2, pbuffertl]); 
// cast dbuf fer (0. . 1] into a short 



offset = (short) ((dbuffertO) « 8) | (dbuffer[l] & OxOOFF) > ; 
bReturnStatus = _OS . SelectFile (of f set ) ; 

} 

break; 

case ISO_VERIFY_KEY: 

// Get the Key from the terminal 
_OS.GetMessage(dbuf fer, pbuf fer [4], pbufferll]); 

bReturnStatus = _OS . VerifyKey (pbuf f er [ 3 ] , 

dbuffer, 
pbuf fer [4] ) ; 

break ; 

case ISO_INIT_APPLICATION: 

// Should send the id of a valid program file 

_OS.GetMes sage (dbuf fer, (byte)l, pbuf fer [1]); 

// compute fileId(of fset) from pbuf fer [2 . .3 ] via casting 

offset = (short) ((pbuffer[2] « 8) | (pbuffer[3] & OxOOFF) ) ; 

bReturnStatus = _OS . Execute (of f set, 

dbuffertO] ); 

break ; 
case GPOS_CREATE_FILE: 

if (pbuf fer [4] != OS_HEADER_SIZE) { 

bReturnStatus = ST_INVALID_PARAMETER ; 
break; 

} 

// Receive The data 

JDS. GetMessage (dbuf fer, pbuffert4], pbufferll]); 
bReturnStatus = _OS.CreateFile (dbuf fer) ; 
}= Z break ; 

fS- case I SO_UPDATE_B INARY : 

_OS.GetMessage( dbuf fer, pbuffer[4], pbufferll]); 
07 // compute offset from pbuf fer (2 . .3 ] via casting 

offset = (short) ((pbuffer[2] « 8) | (pbuffer[3] & OxOOFF)); 

// assumes that a file is already selected 
UT bReturnStatus = _OS.WriteBinaryFile (offset, 

L.= pbuf fer (4), 

E7; dbuffer); 
I jy. break; 

case ISO_READ_BINARY : 
T // compute offset from pbuf fer [2 3 ] via casting 

H offset = (short) ((pbuffer[2] « 8) | (pbuf fer 13] & OxOOFF)); 

fx. // assumes that a file is already selected 

bReturnStatus = _OS .ReadBinaryFile (offset, 
fU pbuf fer [4], 

j- dbuffer); 

// Send the data if successful 
MI ackBytetO] =pbuffer[l]; 

%J if (bReturnStatus == ST_SUCCESS) { 

_OS.SendMessage(ackByte, ACK_SIZE) ; 
_OS.SendMes sage (dbuf fer, pbuf fer [4] ) ; 

} 

break; 
default: 

bReturnStatus = ST_INS_NOT_SUPPORTED ; 

} 

} 

_0S. S ends tatus (bReturnStatus) ; 

} 

} 

while (true) ; 

} 

} 
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APPENDIX F 



Methods For Accessing Card Operating System Capabilities In 
The Preferred Embodiment 



public class _0S { 

static native byte 
static native byte 
static native byte 
static native byte 

static native byte 
static native byte 



SelectFile 
SelectParent 
SelectCD 
SelectRoot 

CreateFile 
DeleteFile 



// General File Manipulation 



static native byte 
static native byte 
static native short 

/ / Header Manipulation 
static native byte 

// Binary File support 
static native byte 



static native byte 



// Record File support 
static native byte 

static native byte 
static native byte 



ResetFile 

ReadByte 

ReadWord 



GetFilelnfo 



ReadBinaryFile 



WriteBinaryFile 



SelectRecord 

NextRecord 
PreviousRecord 



(short 
0 
0 
0 

(byte 
(short 



0 ; 

(byte 
(byte 



(short 
byte 
byte 

(short 
byte 
byte 



(byte 
byte 
<>; 
0 ; 



f ile_id) ; 



file_hdr[] ) ; 
f ile_id) ; 



offset) ; 
offset) ; 



(byte file_hdr[]), 



offset, 

da ta_l ength, 

buffer [] ) ; 

offset, 

da ta_l ength, 

buffer!] ) ; 



record_nb, 
mode) ; 



static native byte 



static native byte 



ReadRecord 



WriteRecord 



(byte 
byte 
byte 
byte 

(byte 
byte 
byte 
byte 



record_data [ ] , 
record_nb, 
offset, 
length) ; 
buf fer [) , 
record_nb , 
offset, 
length) ; 



// Cyclic File Support 
static native byte 

// Messaging Functions 
static native byte 



static native byte 

static native byte 

// Identity Management 
static native byte 
static native byte 



static native byte 



static native byte 



LastUpdatedRec 

GetMessage 

SendMessage 
SetSpeed 

CheckAccess 
VerifyKey 

VerifyCHV 

ModifyCHV 



() ; 



(byte bufferU, 

byte expec ted_l ength , 

byte ack_code) ; 

(byte bufferU, 

byte data_l ength) ; 

(byte speed) ; 



(byte ac_action) ; 

(byte lcey_number, 

byte key_buf fer [ ] , 

byte Jcey_l ength) ; 

( byte CHV_number , 

byte CHV_buf fert ] , 

byte unblock_f lag) ; 

( byte CHV_number , 

byte old_CHV_buf fer [ ] , 

byte new_CHV_buf fer t ] / 



static native byte 
static native byte 



byte 

GetFileStatus (); 
SetFileStatus (byte 



unblock_£lag) ; 
file_status) ; 



static native byte GrantSupervisorMode (); 

static native byte RevokeSupervisorMode ( ) ; 

static native byte SetFileACL (byte file_acl(]); 

static native byte GetFileACL (byte file_aci[]); 



// File context manipulation 



static 


native 


void 


InitFileStatus 


0 ; 








static 


native 


void 


BackupF i leS tatus 


(); 








static 


native 


void 


RestoreFileStatus 


() ; 








// Utilities 














static 


native 


byte 


CompareBuf f er 


(byte 


pattern_ 


length, 








byte 


buf fer_l 


[] . 










byte 


buffer_2[]) ; 


static 


native 


short 


Ava i labl eMemory 


() ; 








static 


native 


void 


ResetCard 


(byte 


mode) ; 




static 


native 


byte 


SendATR 


() , 








static 


native 


byte 


SetDefaultATR 


(byte 


buffer [ 3 










byte 


length) ; 




static 


native 


byte 


Execute 


(short 


file_id. 










byte 


flag) ; 




// Global state variable 


functions 










static 


native 


byte 


Getldentity 


0 








static 


native 


byte 


GetRecordNb 


0 








static 


native 


short 


GetApplicationld 


0 








static 


native 


byte 


GetRecordLength 


0 








static 


native 


byte 


GetFileType 


() 








static 


native 


short 


GetFileLength 


0 








static 


native 


void 


Sends tatus 


(byte 


status) ; 





> 



